본문으로 건너뛰기

Identifier

sidebar_position: 1 title: UC-001: 조건부 정책 등록 tags:

  • SDF

UC-001: 조건부 정책 등록

버전 관리​

버전작성자일자변경 내용
1.0오남규2025-08-22최초 작성

관련 자료​

1. 개요​

본 기능은, SDF에서 라이선스 기반 문서 정책 및 연동 앱을 세밀하게 관리하기 위해 ‘식별자(Identifier)’ 기반의 구조를 도입하여, 문서 추적성과 보안 가시성을 확보하고, 효율적인 라이선스 사용을 지원하기 위한 기능입니다.

2. 공통 정보​

  • 행위자 : 관리자 (SDF 관리 콘솔 접근 권한 보유자)
  • 사전 조건 :
  • 식별자 기반의 라이선스 관리가 활성화된 테넌트일 것
  • 관리자 권한으로 콘솔에 로그인되어 있을 것
  • 연동 앱이 1개 이상 등록되어 있을 것

3. 기본 흐름​

3-1. Trigger​

  • SDF 웹 콘솔 > [라이선스 관리] > 식별자 관리 메뉴 진입

3-2. 주요 흐름​

[식별자 등록]​

  1. 사용 가능한 식별자 수량을 확인합니다.

    • 식별자 수량이 남아있지 않다면 추가 등록 불가 안내 표시

    • 수량이 남아있다면 식별자 추가 등록 가능

      (기능 ID: ID-001)

  2. 식별자 이름을 입력하여 신규 식별자를 등록합니다.

    • 이름은 고유해야 하며, 자동으로 식별자 고유 ID가 생성됩니다.

      (기능 ID: ID-002)

  3. 생성된 식별자에 연동 앱을 자동 할당합니다.

    • 할당 기준은 업무 시스템(앱) URL 기반 자동 매핑

      (기능 ID: ID-003)

[식별자 관리]​

  1. 식별자 이름을 변경할 수 있습니다.

    • 변경 시, 고유 ID는 유지되며 관리자 화면에 변경 이력 표시

      (기능 ID: ID-004)

  2. 등록된 식별자를 검색할 수 있습니다.

    • 식별자 이름 또는 고유 ID로 필터링

      (기능 ID: ID-005)

  3. 식별자의 상태를 변경할 수 있습니다.

    • ‘활성화 / 비활성화’ 중 선택

    • 비활성화된 식별자는 정책에서 사용 불가 상태로 전환됨

      (기능 ID: ID-006)

3-3. 예외 흐름​

  • 식별자 수량이 초과된 경우 → 등록 버튼 비활성화 및 "식별자 수량 초과" 안내
  • 이름이 중복되었을 경우 → 중복 이름 사용 불가 알림 표시
  • 연동 앱이 등록되어 있지 않은 경우 → 자동 할당 시도 실패 및 수동 등록 유도
  • 연동 앱 URL이 명확하지 않거나 중복된 경우 → 매핑 실패 안내

3-4. 사후 조건​

  • 정상 등록 시:
    • [식별자 관리 목록]에 신규 식별자 항목이 추가됨
    • 자동으로 고유 ID가 부여되어 API에서 참조 가능
    • 연동 앱이 식별자 하위에 자동 할당됨
  • 비정상 등록(예외 발생) 시:
    • 오류 메시지를 통해 사용자에게 원인 안내
    • 수정 후 재등록 유도
  • 식별자 상태 변경 시:
    • "비활성화"된 식별자는 정책 적용 대상에서 제외되며, API 호출 시 오류 반환 가능
    • “활성화” 상태 전환 시 즉시 정책 사용 가능